******************** INFO.LCS[DOC,LCS] ***************************

      This file includes  some information  on all  programs written  or
      tampered with by Leland  Smith during April  to July, 1977.   With
      most of these programs file names should not exceed five  letters.
      Usually upper-case letters should be used.

 
	[DOC,LCS]	   [MUS,LCS]	   [SCR,LCS]	   [MU5,LCS]

	USEMUS.DOC	   MUSIC   	   SCORE  	   MUS5
	SCORE.DOC	   FUNC	   	   MIXSCR
	MUSIC.DOC	   WAVES   	   DUPINS
		   	   MIXER



      USEMUS.DOC is a  self-teaching manual for  beginners in using  the
      Stanford-IRCAM MUSIC program.  The  elements of instrument  design
      and the  syntax for  entering  note lists  are dealt  with.   This
      material should  be  covered before  one  begins using  the  SCORE
      program.


      SCORE.DOC is  the complete  manual for  the use  of SCORE.   SCORE
      should be used whenever an extended note list is to be created.


      MUSIC.DOC is a reference manual for MUSIRC.FAI.  In general,  this
      manual need only be referred to by people already well  acquainted
      with the use of the MUSIC program.


      ****** MUSIC -- MUSIRC.FAI ******** on [MUS,LCS]

      This is the  Stanford 'NEWMUS' music  program in its  state as  of
      April 1,  1977, but  with much  obsolete code  removed.  The  main
      features removed were  the possibility of  playing sound  directly
      out of  core (as  opposed to  playing from  a disk  file) and  the
      MAGTAPE output routines.  Added to the program is the  possibility
      of typing 'FINI' instead of 'FINISH', a simple way of of  changing
      the byte size (BITS←n; where n can  be 12 or 18), a simple way  of
      resetting the output file name (OUTFILE←"NAME.MSB";) and a  method
      of reading in external sound files for further processing.   These
      features are mostly described in USEMUS.DOC[DOC,LCS].

      The main music program  must be loaded by  means of the  following
      command file: MUSIRC.CMD 
			
				Type: LOAD @MUSIRC

      When 'INPUT?'  appears  then  type: INIT.IRC  This  reads  in  all
      necessary initialization.   Then the  core image  should be  saved
      under some appropriate name before!! actually playing.

      Reading in INIT.IRC  causes 5  instruments and 6  functions to  be
      predefined in MUSIC.  The instrument  names are SIMP, TOOT,  CLAR,
      BRIT and BUZZ.  Further information is found in USEMUS.DOC.

      MUSIRC.CMD calls  upon  three files,  MUSIRC.FAI,  GETINF.FAI  and
      PLASUB.MAC.  GETINF.FAI  is for  the purpose  of reading  in  four
      separate sound files at a time.  It also has code to unpack 12-bit
      and 18-bit samples.  PLASUB.MAC is  the subroutine version of  the
      PLAY program.




      ****** FUNC ******** on [MUS,LCS]

      This is a program used to create libraries of functions to be used
      by the  MUSIC program.   It produces  line segment  functions  and
      additive sine-wave functions.   It will  also produce  exponential
      curves and has  the capability  of combining  and/or altering  any
      functions in a library.  An approximation of each function can  be
      seen on the display if desired.

      To assemble this program type:  LOAD @FUNC

      This command  file calls  upon FNCDM.F4,  RDFNC.F4, LOOK.FAI,  and
      NODM.MAC.

      NOTE!! This program reads upper-case letters only.


      ****** WAVES ******** on [MUS,LCS]

      WAVES is a program for the  purpose of displaying the contents  of
      sound files produced by any system.  The program expects that  the
      file has a standard 128-word header, however in most cases it will
      work even if  there is  no header.   WAVES has  the provision  for
      writing a DSK file which may be listed on the LPT.  This will give
      a very long continuous graphic  representation of a sound.  

      NOTE:  This feature creates a very large DSK file.  It is best not
      to print more than about 1500 sound samples at a time.  To run the
      program to change the  format for printing,  type R WAVLPT.   This
      reads the  file  WAVES.DAT  (which  was  produced  by  WAVES)  and
      rewrites it in a new format.  This new form then should be  listed
      on the LPT with the PRINT command. 
      Then be sure to delete WAVES.DAT.

      WAVES is made up of two source files:  WAVES.F4, WAVIN.FAI





      ****** MIXER ******** on [MUS,LCS]

      This program is a  simple sound file mixer.   It will combine  any
      two sound  files of  the same  format.  Each  file may  be  scaled
      individually.  It also  contains a feature  for rapid splicing  of
      sound files when no scaling or combining is desired.  This program
      is self-contained in MIXER.FAI.


      ****** SCORE ******** on [SCR,LCS] 

      The SCORE program  has been made  to run with  the DEC  FORTRAN-10
      compiler.  A  method of  notating chords  has been  added to  this
      system.

      The SCORE program must be loaded by means of the following command
      file: SCORE.CMD.
			   Type: LOAD @SCORE

      SCORE is assembled from five  main files, SC1.F4, SC2.F4,  SC3.F4,
      SCANR.F4 and  SPRINT.FAI.  The  command  file also  loads  SUBR.F4
      which is a microtone notation package (see SCORE.DOC[DOC,LCS].)

      SCORE.REL[SCR,LCS] is produced with the COPY command:

          COPY SCORE.REL=SC1.REL,SC2.REL,SC3.REL,SCANR.REL,SPRINT.REL

      SCORE.REL is  used  when  the  SCORE  program  is  loaded  with  a
      user-written subroutine (in place of SUBR.F4.)




      ****** MIXSCR ******** on [SCR,LCS]

      This allows you to  combine any two .SCR  files (the output  files
      from SCORE.)  This program is needed only when the amount of input
      data will  exceed the  limits  of the  SCORE program.   There  two
      source files needed, MIXSCR.F4 and RENAM.FAI.




      ****** DUPINS ******** on [SCR,LCS]

      This  is  for   the  rapid  duplication   of  'MUSIC'   instrument
      definitions.  This is necessary when the chord writing features or
      duty-factor overlapping note features  of the 'SCORE' program  are
      used.  The duplicate  instruments are  given names  with the  last
      letter going up the alphabet. (TOOTA, TOOTB, TOOTC, etc.)  The two
      source files required are DUPINS.F4 and FORNAM.FAI.


      ****** MUS5 -- MUSIC5 TRANSLATOR ****** on [MU5,LCS] 

      This is a set  of subroutines which are  combined with a  slightly
      altered version of  PASS3 of  MUSIC5 (old  version, c.1970.)   The
      running program is called MUS5.EXE[MU5,LCS].  (.EXE is like  .SAV)
      In this program standard MUSIC5 instrument and GEN definitions are
      used  but  the  syntax  for  the  score  proper  is  that  of  the
      Stanford-IRCAM MUSIC program.  Thus output from SCORE can be  used
      as input  to this  form of  PASS3  of MUSIC5.   Also most  of  the
      interactive features of  MUSIC are available.   A fairly  complete
      write-up of  the  translator  appears  at  the  top  of  the  file
      MUS5TR.F4.  To assemble this program type:  'DO DOMUS5.'.

      This runs  DEC's  'MIC'  system which  handles  several  different
      commands.  The source files are MUS5.F4, MUS5TR.F4, MUS5IO.FAI and
      PLASUB.MAC[MUS,LCS].  MUS5.F4  is PASS3  of MUSIC5  with calls  to
      MUS5TR for  reading  data.   MUS5TR.F4  is  the  translator  which
      converts 'MUSIC' input to  'MUSIC5' format.  MUS5IO.FAI packs  the
      samples from PASS3 three  to a word and  writes them on the  disk.
      PLASUB.MAC  plays  the  finished  file.   MUS5TR  is  also   being
      implemented with John Gardner's extended version of MUSIC5.  Since
      PASS3 and MUS5TR  are all in  FORTRAN it is  hoped that someday  a
      version of this system will be adapted to a PDP11.